Categories

Versions

Extract Macro (Format) (Operator Toolbox)

Synopsis

This operator is giving you the similar functionality than Extract Macro, but allows you to specify date and numerical formats. The operator also allows you to extract the size of a collection.

Description

This operator can be used to define a single macro which can be used by %{macro_name} in parameter values of succeeding operators of the current process. The macro value will be derived from the input ExampleSet. A macro can be considered as a value that can be used by all operators of the current process that come after the macro has been defined. This operator can also be used to re-define an existing macro.

Input

  • exa (Data table)

    This input port expects an ExampleSet or an IOObjectCollection. The macro value will be extracted from this ExampleSet or the size of the collection.

Output

  • exa (Data table)

    The ExampleSet or IOObjectCollection that was given as input is passed without changing to the output through this port. This is usually used to reuse the same object in further operators. It is not compulsory to attach this port to any other port, Macro value is set even if this port is left without connections.

Parameters

  • macro This parameter is used to name the macro and can be accessed in succeeding operators of current process by writing the macro name in %{macro_name} format, where 'macro_name' is the name of the macro specified by this parameter.
  • macro type Indicates the way how the macro should be defined.
  • statistics The statistics of the specified attribute which should be used as macro value.
  • attribute name The name of the attribute from which the data should be derived.
  • attribute value The value of the attribute which should be counted.
  • example index The index of the example from which the data should be derived. Negative indices are counted from the end of the data set. Positive counting starts with 1, negative counting with -1.
  • format of numericals Format for numerical outputs. #.## indicates values in the form: 3.14, while #.##E00 indicates scientific notation, e.g. 3.14E00. The used implementation is Java's DecimalFormat class.
  • date format This is the most important parameter of this operator. It specifies the date time format of the desired nominal attribute. This date format string specifies what portion of the date attribute should be stored in the nominal attribute. Date format strings are discussed in detail in the description of Date to Nominal.
  • locale The used locale for date texts, for example "Wed" (English) in contrast to "Mi" (German).

Tutorial Processes

Extracting a Single Cell with a Specified Number Format

In this tutorial process we create random data and extract the first value of att1 with a specified number format. We later display the result as an ExampleSet.